home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir24 / scnwiz30.zip / 300.DOC next >
Text File  |  1994-04-16  |  19KB  |  372 lines
  1.    SCANWIZ Version 3.00
  2.    April 1994                                   by MOUNTAIN GOAT SOFTWARE
  3.    **********************************************************************
  4.  
  5.    We have mailed a donation to Jim Shelton, and you should too.  Do it
  6.    immediately if you use Autoroll!
  7.  
  8.    First of all, you must place the following files in the same 
  9.    directory to run this version: SCANWIZ.EXE, SCANWIZ.INI, MAKLOAD.EXE
  10.    and CF.COM.  These are the same MAKLOAD and CF programs used in the
  11.    past, but the SCANWIZ.INI is new and different.  Old .INI files 
  12.    WILL NOT WORK with Version 3.00.
  13.  
  14.    SCANWIZ can now be of assistance to you in uploading codes to the
  15.    VC Ram or in downloading your VC Ram into a Now/Next code list. It's
  16.    really up to the user how to best make use of this program.  The
  17.    development of this program has been user guided.  We would ask that
  18.    you read the docs on Version 3.00, since there have been MANY
  19.    changes!
  20.  
  21.    This version is in response to the remarkable bit of programming done
  22.    on the Autoroll series.  Version 5.3 of Autoroll brings the ability to
  23.    upload/download wizard codes to and from a VC2 and a PC.  This version
  24.    has been designed to facilitate the automatic file creation that the
  25.    new VC-PC link allows.  No longer will it be necessary to key in any
  26.    codes whatsoever to the file list (if you have seeds, that is).  You
  27.    can configure your Autoroll and software to read all codes into your
  28.    PC and then execute Scanwiz Version 3.00 to produce a NOW/NEXT sorted
  29.    wiz file that will correctly list every code in your VC2 RAM.
  30.    
  31.    One quick point.  If you download codes from your RAM and then create
  32.    a wiz file, you should get rid of the old codes in your ram first.
  33.    Let's say you have codes for G1-07 in your RAM but they are old and
  34.    you have no newer ones.  Change them to 0000 0000 0000 00 in RAM and
  35.    they won't show up to clutter up your wiz file.  Either that or add
  36.    G1-07 to the [BLOCK CHANNELS] section of SCANWIZ.INI.
  37.  
  38.    You can operate this new version automatically from the DOS prompt.
  39.    This version will allow wiz lists to be selected from the command line.
  40.    No longer will you have to key in the file name after the program is
  41.    running.  Additionally, you may enter an output file name on the 
  42.    command line and instruct SCANWIZ to ignore any channels it does not
  43.    recognize in a code list (that shouldn't happen if you're reading 
  44.    LOAD.TXT).  The default input file name is now LOAD.TXT, rather than
  45.    TESTFILE as in the past.
  46.    
  47.    Of course, this version can be run in the normal fashion and it will
  48.    attempt to sort Even/Odd codes into Now/Next for the first time.  We
  49.    don't guarantee 100% accuracy, but it seems to work most of the time.
  50.    It is nice to enter the file names while you are looking at them on
  51.    the screen in front of you.  No more going on memory or writing them
  52.    down.  By the way, we don't GUARANTEE anything!!!
  53.    
  54.    If you have the ability to write simple DOS batch files, you can
  55.    automate the entire process.  Fire up the batch file and your PC
  56.    will collect codes from your VC2 and write a very accurate code
  57.    list in NOW/NEXT format while you twiddle your thumbs.  It couldn't
  58.    be easier.  It couldn't be more accurate.
  59.    
  60.                             *****************
  61.                             THE COMMAND LINE.
  62.                             *****************
  63.                             
  64.    The DOS command line is where you call on a program to run.  Normally,
  65.    you would enter the name of the executable file:  C:> SCANWIZ [ENTER].
  66.    Scanwiz V3.00 will run normally if you do that.  You may now add 
  67.    parameters to the command line.  You may specify which of the three
  68.    lists of C.I.D.'s in SCANWIZ.INI to use (most just use #1).  The default
  69.    is list #1.  You may enter up to five wizard file names (the default is
  70.    LOAD.TXT).  You may enter the output file name by placing = directly
  71.    before the name (no space in between).  You may also instruct Scanwiz
  72.    to ignore any channels it does not recognize.  It will still beep, but
  73.    it will carry on and not stop.
  74.    
  75.            To select CID list #2, add:   /2 or \2
  76.            To select CID list #3, add:   /3 or \3
  77.            To select Ignore unknown channels:   /I
  78.            To bypass Opening Screens and use default file names: /B
  79.    
  80.            To enter input file names:  Leave a space on both sides of the
  81.                                        file name.  Do not put a / or \ in
  82.                                        front of it.
  83.    
  84.            To enter the output file name:  Place = directly in front of the
  85.                                            name (no space).
  86.    
  87.            To work in silence:  /S will disable the sound feature.
  88.  
  89.    You may combine commands.  If you are reading a LOAD.TXT file and wish 
  90.    to call your output file WIZ0401.TXT, you might enter:
  91.    
  92.                          SCANWIZ /B =WIZ0401.TXT
  93.    
  94.    This will use the default file name of LOAD.TXT for the input file and
  95.    then output to a file named WIZ0401.TXT.
  96.    
  97.    If anything odd is found in the command line, Scanwiz should stop, but
  98.    this is unpredictable.   
  99.  
  100.                             ****************
  101.                              C.I.D. OPTIONS
  102.                             ****************
  103.  
  104.    Older versions of Scanwiz gave the user three Channel I.D. output 
  105.    choices:  you could use the channel I.D.'s in the three database
  106.    lists in SCANWIZ.INI, you could write 86 to them all (or another
  107.    value if you changed it in .INI), or you could overwrite all C.I.D.'s
  108.    with whatever values were found on the scanned lists.
  109.  
  110.    This approach is now obsolete.  Most users simply want to dictate
  111.    exactly which Channel I.D.'s will be sent to the output file.  The
  112.    write 86 to all and overwrite options have been eliminated.  You
  113.    simply choose the database list (usually #1) that you wish to use.
  114.  
  115.  
  116.                            ******************
  117.                            LOAD.TXT PROBLEMS.
  118.                            ******************
  119.                            
  120.    Some have expressed a problem in reading LOAD.TXT, because SCANWIZ writes
  121.    a new LOAD.TXT file over their old one.  This is unavoidable because
  122.    SCANWIZ uses it's newly written LOAD.TXT file to write AUTO.LDR.  
  123.  
  124.    [Well, it is AVOIDABLE.  See Output Options to eliminate the overwrite.]
  125.  
  126.    The simple solution to this is to write a batch file something like this:
  127.    
  128.                    ERASE DOWNLOAD.TXT
  129.                    RENAME LOAD.TXT DOWNLOAD.TXT
  130.                    SCANWIZ DOWNLOAD.TXT =WIZDATE.TXT
  131.    
  132.    Call it WIZ.BAT.  Then type WIZ [ENTER] and the problem is solved.  
  133.    You need the ERASE line because newer versions of DOS will not rename 
  134.    a file to a name already in use.
  135.    
  136.    Ideally, you may combine the instructions for AUTOROLL with the above
  137.    technique to produce a batch file that will do it ALL.  Just add
  138.    the line VCHOST at the top.  (VCHOST comes in the file AUTORL53.ZIP)
  139.    
  140.            WIZ.BAT
  141.    
  142.                    VCHOST 
  143.                    ERASE DOWNLOAD.TXT
  144.                    RENAME LOAD.TXT DOWNLOAD.TXT
  145.                    SCANWIZ DOWNLOAD.TXT =WIZDATE.TXT
  146.    
  147.    If you are really fancy, you can set up the batch file to read command
  148.    line parameters to determine the output file name.
  149.    
  150.                    VCHOST
  151.                    ERASE DOWNLOAD.TXT
  152.                    RENAME LOAD.TXT DOWNLOAD.TXT
  153.                    SCANWIZ DOWNLOAD.TXT =%1
  154.    
  155.    Then at the command line, enter something like this:
  156.    
  157.            C:\> WIZ WIZDATE.TXT
  158.    
  159.    and stand back!  The VC should download data to your LOAD.TXT file.
  160.    Then the batch file will rename LOAD.TXT to DOWNLOAD.TXT, process 
  161.    that file and write both a new LOAD.TXT file and a text file in 
  162.    NOW/NEXT format called whatever you specified on the command line
  163.    that started the batch file.
  164.    
  165.    Note that VCHOST defaults to COM1.  If you use COM2, you must 
  166.    enter VCHOST 2 on the first line.
  167.    
  168.    Play with it.  Find your own best solution.  The command line
  169.    approach makes it all possible from a batch file.
  170.    
  171.                          ***********************
  172.                          OTHER LOAD.TXT CONCERNS
  173.                          ***********************
  174.                          
  175.    Some have the ability to secure codes for both the A0 and 7B service
  176.    I.D.'s for some channels.  If you configure your Autoroll correctly,
  177.    this is no problem.  If you can collect both for G5-01 for example,
  178.    choose which pair you wish to print out first and load the seeds for
  179.    that one first in Autoroll. Make sure your list in [AUTOROLL CHANNELS]
  180.    in SCANWIZ.INI exactly matches your Autoroll configuration.  It's OK
  181.    to enter G5-01 in two different locations.  Use A0 seeds for the first
  182.    one and 7B seeds for the second one.  Both sets of codes for G5-01 
  183.    should download to LOAD.TXT through the serial connection.  Scanwiz
  184.    will do the rest.  The LOAD.TXT file that is written by Scanwiz WILL
  185.    NOT CONTAIN both sets of codes, however.  That's why some may wish to
  186.    rename LOAD.TXT in order to preserve the full list.
  187.    
  188.  
  189.                            *********************
  190.                            BLOCK CHANNEL WRITING
  191.                            *********************
  192.  
  193.    There is a new section called [BLOCK CHANNEL WRITING] in the revised
  194.    SCANWIZ.INI file.  There may be some channels that you would like
  195.    Scanwiz to recognize, but not print out.  If a channel moves, for
  196.    example, many lists will be slow to make the change.  Let's say
  197.    the idiots move Disney-W from G1-07 to G1-13.  You may find G1-07
  198.    in lists for another week or more.  You can now add G1-13 to the
  199.    [SCANWIZ CHANNELS] section, but LEAVE G1-07 there!  If Scanwiz finds
  200.    a code for G1-07, you can force it to move it to G1-13 by adding
  201.    G1-13=G1-07 to the [EQUIVALENCY] section.  Then, add G1-07 to the
  202.    [BLOCK CHANNEL WRITING] section.  Another example of the Block
  203.    Channel function relates to sports codes.  You may wish to limit
  204.    or eliminate some or all of the sports channels running on the sports
  205.    code from your list.  INFO SOCIETY does this.  It's up to you.  BUT,
  206.    it is best to leave the sports channels in [SCANWIZ CHANNELS] so 
  207.    that Scanwiz has a better chance to find the sports code!
  208.  
  209.    Another consideration concerning blocking the writing of all of the
  210.    sports channels is that if F1-10 is not printed to your output file,
  211.    it will not be placed in LOAD.TXT, or AUTO.LDR at all.  The simple
  212.    solution to this is to change "F1-10" in [AUTOROLL CHANNELS] to
  213.    "SPORT".  That will carry the code to the loader.
  214.  
  215.  
  216.                          *************************
  217.                          PLACEHOLDERS FOR UPDATING
  218.                          *************************
  219.  
  220.    If you do not have seeds or are missing seeds for some channels, it
  221.    is still helpful to use Scanwiz to update your code list.  Let's 
  222.    take a TUESDAY for example.  The following codes update on a Tuesday:
  223.    G1-07, F3-01, F3-04, F3-13, F3-16, F3-18, F3-21, G5-01, G5-12, E1-28, 
  224.    S3-05, S3-09, S3-15 and F2-16.
  225.  
  226.         1. Copy Monday night's list to a new file name for Tuesday.
  227.  
  228.         2. Blank out a chunk (maybe 4 bytes) of the current code for
  229.            all channels that are changing on Tuesday. Use a text editor.
  230.  
  231.         3. If you have no seeds for a channel that rolls and you don't
  232.            even know the next code, you may wish to enter the following
  233.            code into the Now position:
  234.     
  235.                              0001 0000 0000 00MM SS
  236.  
  237.            Don't actually use M's and S's.  These simply indicate that
  238.            M=Month I.D. and S=Service I.D.  This will hold a place for
  239.            the new current code should you get it.  This might apply to
  240.            ACTION (which only sends the current code) or E1-28, which
  241.            some cannot receive at all.  You have to do this because
  242.            Scanwiz has been taught two things.  It will ignore an all-
  243.            zero code and it will not print to the file any channel with
  244.            no codes found.  If you just wish to print blank lines for
  245.            a channel like ACTION, you may add it to the [FORCE PRINT]
  246.            section of SCANWIZ.INI.  You will lose the month and channel
  247.            I.D.'s this way but a place will be retained for the channel.
  248.  
  249.         4. Run Scanwiz.  Let's say you named your new file TUESDAY.
  250.            C:> SCANWIZ TUESDAY =TUESDAY will read the file and move
  251.            the next codes for Tuesday to the current position for the
  252.            channels that will roll.
  253.  
  254.         5. Key in the new next codes for the rolling channels.  
  255.  
  256.                              **************
  257.                              OUTPUT OPTIONS
  258.                              **************
  259.  
  260.    If you examine SCANWIZ.INI you will find the first parameter in 
  261.    it is now entitled [OUTPUT OPTIONS].  This value should be 1 or
  262.    2 or 3.  It comes configured with it set to 3.  Here's what the
  263.    values will output:
  264.  
  265.                 1 - Print out the text file only.
  266.                 2 - Print out the text file, SCAN.OUT and the 
  267.                     LOAD.TXT file (Requires MAKLOAD.EXE)
  268.                 3 - Print out the text file, SCAN.OUT, the 
  269.                     LOAD.TXT file and AUTO.LDR. (Requires CF.COM)
  270.  
  271.    With all of the different users out there, you each have your own
  272.    needs.  If you use the VC-PC link by Jim Shelton, you don't need
  273.    AUTO.LDR at all.  If you just want the text file, you have that
  274.    option.  Be sure the value is 1, 2 or 3.
  275.  
  276.    You might note that Option 1 will operate without writing a new
  277.    LOAD.TXT file at all.  Therefore, if you are preparing a code list
  278.    after downloading from AUTOROLL, this option will do the trick
  279.    without overwriting your LOAD.TXT file.
  280.  
  281.                               *************
  282.                                OTHER NOTES
  283.                               *************
  284.  
  285.    The only new file format we've seen recently was a VMS text file.
  286.    This version of Scanwiz will now read such a text file.  Thanks to
  287.    those that leave messages on NASAT!
  288.  
  289.    SCANWIZ.INI can be edited to suit your needs.  It comes configured
  290.    to work with a stock AUTORL53.RUN setup.  If you change the order
  291.    or position of channels in RUN, you should change them in SCANWIZ.INI.
  292.    Jim Shelton lists the Canadian Family Channel as E2-30, while the
  293.    INFO SOCIETY BBS now uses E1-28.  Scanwiz will convert E2-30 to E1-28
  294.    anyway.  Let's say you want it to be E1-30.  What should you do?
  295.    Put E1-30 in the [SCANWIZ CHANNELS] section.  Add E1-30=E1-28 to the
  296.    [EQUIVALENCY] section.  Then add E1-28 to the [BLOCK CHANNEL WRITING] 
  297.    section. This will allow E2-30 to be eventually converted to E1-30 ...
  298.    This technique may be handy when the next channel move occurs.
  299.  
  300.    A dummy LOAD.TXT file is provided.  It too is configured like the
  301.    AUTORL53.RUN file.  To produce such a dummy file, set the output
  302.    option to 2 or 3 in the .INI file and scan a file with no codes in it!
  303.    The dummy file will not show the old C.I.D.'s unless you add each
  304.    channel that is in [AUTOROLL CHANNELS] to [FORCE PRINT].  This is
  305.    because the LOAD.TXT file is produced from the text file you
  306.    create.  If the channels are listed in the created file WITH their
  307.    C.I.D.'s, those I.D.'s will write to LOAD.TXT.  Not a big deal.
  308.  
  309.    The dummy LOAD.TXT file is called LOAD.TX1 so that it won't be
  310.    overwritten by the first use of SCANWIZ.
  311.  
  312.    The files that you scan to and from need not be in the same directory
  313.    as the Scanwiz files.  Let's say your downloads are in C:\DOWNLOAD.
  314.    You can enter the following:
  315.  
  316.                SCANWIZ C:\DOWNLOAD\WIZFILE.TXT =D:OUTPUT
  317.  
  318.    This will read WIZFILE.TXT in the directory C:\DOWNLOAD and output
  319.    the file OUTPUT in the directory D:\.  Just thought we'd tell you
  320.    that in case you missed it in the 20 previous versions and docs.
  321.  
  322.  
  323.                            *****************
  324.                            SPEED ENHANCEMENT
  325.                            *****************
  326.  
  327.    Some of the scanning and analysis routines have been rewritten to
  328.    improve the speed of the program.  Our tests show that this version
  329.    will run typically 25% faster than Version 2.20.  This may be 10
  330.    seconds to those of you with a 486, but it can mean minutes if you
  331.    are running it on an XT.
  332.  
  333.                          **********************
  334.                           BUGS .. BUGS .. BUGS
  335.                          **********************
  336.  
  337.    We hope you will agree that this version has been worth waiting for.
  338.    It probably has some bugs, but we are testing it much longer that we
  339.    have tested any other version.  The major rewrite makes this necessary.
  340.    After two days of testing in February, we uploaded V2.00 and it was
  341.    buggy.  We have tried to avoid repeating history.
  342.  
  343.  
  344.                          **********************
  345.                          THE HEIGHT OF LAZINESS
  346.                          **********************
  347.                            
  348.    The author of Scanwiz hopes this Autoroll-Scanwiz solution will make
  349.    code collection and distribution deadly accurate and easy.  The author
  350.    of Scanwiz owns the sky over his head and everything that's in it.  And
  351.    that's the way God meant things to be ...
  352.    
  353.    We have found satellite BBS people to be great friends. That is reward
  354.    enough.  We may solicit a little help from time to time. And thanks 
  355.    to all of you for your support, suggestions, comments and praise.
  356.  
  357.  
  358.    MOUNTAIN GOAT SOFTWARE 
  359.  
  360.  
  361.                   --------------------------------- 
  362.                   CALL GROUND CONTROL SATELLITE BBS 
  363.                   --------------------------------- 
  364.              LATEST NEWS FROM THE SATELLITE UNDERGROUND 
  365.                  ========== (905)723-5059 ========== 
  366.                         - 1200--14.4 BAUD V.32 
  367.              - WIZZARD CODES UPDATED SEVERAL TIMES DAILY 
  368.                 - VIDEOCIPHER NEWS & FILES AVAILABLE 
  369.                          Sysop: EIGHTBALL 
  370.                    24 HOURS A DAY  7 DAYS A WEEK! 
  371.                         ONLINE SINCE DEC/92 
  372.